home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Electronic Messages / USEnet Digests / USEnet Vol. 3 / USEnet 3.063 < prev    next >
Encoding:
Text File  |  1988-04-08  |  32.9 KB  |  782 lines  |  [TEXT/ttxt]

  1. 29-Sep-87 09:45:32-PDT,34418;000000000001
  2. Date: Fri 28 Aug 87 21:22:02-GMT
  3. From: Jeff Shulman <SHULMAN@SDR>
  4. Subject: Usenet Mac Digest V3 #63
  5.  
  6. Usenet Mac Digest     Friday, August 28, 1987        Volume 3 : Issue 63 
  7.  
  8. Today's Topics:
  9.      DiskTimer III Proposal - Comments?
  10.      Re: Mac <-> VMEbus ??
  11.      Hypercard Reports
  12.      Re: MPW and MultiFinder
  13.      Re: Hard Disks
  14.      Macintosh XL, SCSI, and hard disk drives.
  15.      Re: Which Is Better: DMCS or Concertware+?
  16.      Comments on SuperMac 19" Trinitron monitor system (longish)
  17.      Re: MPW and MultiFinder
  18.      Mac File Representation
  19.      Remote file representation
  20.  
  21. ---------------------------------------------------------------------- 
  22.  
  23. From: ephraim@wang7.UUCP (ephraim)
  24. Subject: DiskTimer III Proposal - Comments?
  25. Date: 25 Aug 87 14:56:27 GMT
  26. Organization: Wang Laboratories, Lowell, MA, USA
  27.  
  28. I am discussing with Steve Brecher the creation of a new version of
  29. DiskTimer (DT III) to avoid or reduce certain problems with DiskTimer
  30. II's measurements of disk performance.  At his suggestion, I'm taking
  31. the discussion public with this request for comments.  Please mail
  32. responses to decvax!masscomp!wang7!ephraim (if you can), MASSTECH on MCI
  33. mail (if that's easier for you), or Ephraim Vishniac / P.O. Box 1357 /
  34. East Arlington, MA 02174 if e-mail just doesn't do it for you. Please
  35. understand that DiskTimer III is intended to be in the same general vein
  36. as DiskTimer II.  That is, it will be a non-destructive test of a disk
  37. drive's data transfer rate measured at the driver interface.  It will
  38. not be a test of system performance, so correlation with a user's
  39. expectation of performance will continue to be problematic.
  40.  
  41. ---------Start of technical stuff-----------
  42.  
  43. DiskTimer II attempts to measure the data transfer rate of a disk drive
  44. under optimal conditions, i.e., with a minimum of head and cylinder
  45. crossings.  To do so, it makes elaborate efforts to locate a region of
  46. the disk which presents the least data transfer time, then makes
  47. repeated measurents of read/write times in that region.
  48.  
  49. There are (at least) two failings in this approach.  First, this optimal
  50. case is not typical.  Files are not placed with respect to tracks or
  51. cylinders, so their boundaries will often be crossed in the course of a
  52. single I/O operation. Of course, if DiskTimer tested a single region
  53. without the precautions that it now takes, drives which happened to seek
  54. in that region would be unfairly penalized.
  55.  
  56. Second, this approach fails completely to measure data transfer time
  57. when the driver incorporates a local cache.  Since the same region is
  58. read and written repeatedly, DiskTimer II presents an optimal caching
  59. situation.  This is the cause of the ridiculous results that one vendor
  60. was touting in sales literature at the Boston MacWorld show.
  61.  
  62. The major feature of DiskTimer III is a change in approach that avoids
  63. both of the above problems.  Rather than read/write the same area 100
  64. times, DT III will read/write consecutive areas of the disk.  So, track
  65. and cylinder crossings will be represented in their native proportions. 
  66. With respect to caching, the test will be pessimal instead of optimal. 
  67. Since the test is for raw data transfer rate, this is exactly as it
  68. should be.
  69.  
  70. To be more precise about the test sequence, DT III will:
  71.  
  72.     read CurrentTestSector - 1 into TrashBuffer
  73.     dither-with-respect-to-system-tick-and-disk-rotation
  74.     start ReadTimer
  75.     read 24K at CurrentTestSector into DataBuffer
  76.     stop ReadTimer
  77.     read CurrentTestSector - 1 into TrashBuffer
  78.     dither-with-respect-to-system-tick-and-disk-rotation
  79.     start WriteTimer
  80.     write 24K at CurrentTestSector from DataBuffer
  81.     stop WriteTimer
  82.     advance CurrentTestSector by 24K/SectorSize for a total of 100 reads
  83. and 100 writes.  Of course, there will be tests to avoid running off the
  84. end of the volume, to stop on I/O errors, etc.  The same general idea
  85. will be used on the Seek portion of the benchmark, to insure that the
  86. drive really does seek instead of returning cached data.
  87.  
  88. Minor new features of DiskTimer III will include:
  89.     reporting the disk driver's name, icon, and 'where' string
  90.     reporting the system version, ROM version, and CPU type
  91.     user selection of the volume to test
  92.     if SCSI drive, report Vendor ID and Product ID from SCSI Inquiry
  93.  
  94. Since DiskTimer III results will not be directly comparable to DT II
  95. results, there will be a new scale.
  96.  
  97. So: What problems am I introducing? What other problems should I
  98. address?
  99.  
  100. -----------End of technical stuff----------
  101.  
  102. -- Ephraim Vishniac 
  103. masscomp!wang7!ephraim
  104.  
  105. ------------------------------
  106.  
  107. From: taylor@cernvax.UUCP (taylor)
  108. Subject: Re: Mac <-> VMEbus ??
  109. Date: 25 Aug 87 12:56:37 GMT
  110. Organization: CERN European Organization for Nuclear Research
  111.  
  112. CERN has developed VMEbus interfaces for the complete Macintosh family.
  113. The system is called MacVEE (Microcomputer Applied to the Control of VME
  114. Electronic Equipment), and it provides direct memory-mapped access to
  115. single or multi-crate VMEbus or CAMAC systems from the Macintosh,
  116. Macintosh Enhanced, Macintosh Plus or Macintosh SE.
  117.  
  118. The MacVEE interface for Macintosh II (MICRON - MacVEE Interface Card
  119. Resident On NuBus) is currently being polished for production and should
  120. be available 4Q/87.  It is compatible with the same VMEbus master module
  121. and CAMAC crate controller as the earlier systems.  Installation is
  122. easier, because MICRON simply plugs into a NuBus slot in Mac II.
  123.  
  124. The development of MICRON is supported by C. Rubbia and is being carried
  125. out with the assistance of the UA1 experiment collaboration, comprising
  126. members from CERN EF, EP and DD Divisions.
  127.  
  128. The latest version of the MacVEE User Manual is available to
  129. professional researchers from:
  130.  
  131. B.G. Taylor
  132. EP Division
  133. CERN (European Organization for Nuclear Research)
  134. CH-1211 Geneva 23
  135. Switzerland
  136.  
  137. BITNET:  bgt.wb@gen
  138. ARPANET: bgt.wb%gen.bitnet@wiscvm.arpa          (while it lasts...)
  139.  
  140. ------------------------------
  141.  
  142. From: waltervj@dartvax.UUCP (walter jeffries)
  143. Subject: Hypercard Reports
  144. Date: 24 Aug 87 14:05:33 GMT
  145. Organization: Dartmouth College, Hanover, NH
  146.  
  147. Has anyone figured out how to print non-standard reports in HyperCard?
  148.  
  149. I want to make a stack that keeps data and then from that data fills out
  150. forms that are larger than the size of a single card.  To do so it would
  151. seem that I need to use a report. Unfortunately the reports seem to be
  152. very constrained as to what and how they will print things out.
  153.  
  154. Does anyone have any other ways of filling out a standard form?  Or of
  155. using a report so that you can control precisely where things can go?
  156.  
  157. Thanx in advance...
  158.   -Waltervj@dartvax
  159.  
  160.  
  161. ------------------------------
  162.  
  163. From: jww@sdcsvax.UCSD.EDU (Joel West)
  164. Subject: Re: MPW and MultiFinder
  165. Date: 26 Aug 87 14:18:37 GMT
  166. Organization: Palomar Software, Inc., Vista, CA
  167.  
  168. Actually, there was a very good article about GetNextEvent, etc. on Bix
  169. that will be in Byte.
  170.  
  171. Since MultiFinder steals the time if it sees two nullEvt's in a row,
  172. it's even possible to work with GetNextEvent-compiled programs, as Tom
  173. Thompson of Byte demonstrated.
  174.  
  175.  
  176. ------------------------------
  177.  
  178. From: graifer@net1.ucsd.edu (Dan Graifer)
  179. Subject: Re: Hard Disks
  180. Date: 26 Aug 87 17:27:40 GMT
  181. Organization: UCSD Office of Academic Computing
  182.  
  183.  
  184. About once a month, somebody new asks the net for opinions on hard
  185. disks. The Macintosh magazines do comparative reviews, but they are
  186. always way out of date, and don't always cover the whole market.
  187.  
  188. I am probably going to be sorry I did this, but I hereby volunteer to
  189. gather some statistics.  Before you hit your (r)espond keys, let's think
  190. about this. I want ONE LINE responses, with STANDARD TAB SEPARATED
  191. FIELDS.  I can then use switcher to paste the responses into my db.  I
  192. would propose the following:
  193.  
  194. Make
  195.   SuperMac
  196. Model
  197.   DataFrame 20
  198. DriveMake
  199.   NA
  200. Capacity MB
  201.   21
  202. Type
  203.   SIDE (other responses are: UNDER, INTERNAL, OTHER)
  204. Port
  205.   SCSI (OTHER)
  206. DiskTimRead
  207.   98
  208. DiskTimerWrite
  209.   99
  210. DiskTImerAccess
  211.   69
  212.     (My XP upgrade is on order!  I know DiskTimer results can be misleading,
  213.      but it is the only standardized test we have.  I will include a notice
  214.      in any reports that I release)
  215. HardwareReliability
  216.   5 (scale 0-5)
  217. MakerResponsiveness
  218.   4 (scale 0-5)
  219. Software
  220.   SPOOLER (vs NOSPOOLER)
  221.   BACKUP (vs NOBACKUP)
  222. Noise
  223.   2 (0=Silent to 5=banshee)
  224.  
  225.  
  226. Thus my response would be
  227.  
  228. SUPERMAC DATAFRAME 20 NA 21 SIDE SCSI 98 99 69 5 4 SPOOLER BACKUP 2
  229. [ TABS converted to spaces for digest - Jeff ]
  230.  
  231. Is the potential for lines longer than 80 chars a problem for some
  232. hosts?  Are there important fields I am missing?  Before I ask for
  233. responses, lets hash this out.  Once I post the final format,  I would
  234. want EVERYONE on the net who has a hard disk to send me a response. 
  235. Only post if you cannot E-mail with repeated tries!
  236.  
  237. I may loose net access by the end of this year.  If so, I will mail
  238. somebody else the DB. I hope I am not going to be sorry I did this. 
  239. Hopefully, after this has exhausted me in a few months, someone else
  240. will take over the job for a quarter. I expect to get a hundred
  241. responses immediately, and maybe that many again over the next year. 
  242. The resulting reports, and maybe even the database could then be posted
  243. here or in the sources group.
  244.  
  245. PS, Oh, do you think date of purchase should be in the DB?  I don't want
  246. to ask for price, as some may not want to reveal special deals, and
  247. thats subject to change over time anyways.
  248.                               Dan Graifer
  249.                               graifer@net1.UCSD.EDU
  250. Disclaimer: Nobody ever listens to me anyways; Why should they start now?
  251.  
  252. ------------------------------
  253.  
  254. From: britt@venera.isi.edu (Benjamin Britt)
  255. Subject: Macintosh XL, SCSI, and hard disk drives.
  256. Date: 26 Aug 87 04:07:15 GMT
  257. Organization: Information Sciences Institute, Univ. of So. California
  258.  
  259. Is there a SCSI board for the Macintosh XL? It looks simple enough to
  260. have been done but I have had little luck even finding anyone selling
  261. prototyping boards for the XL.  Sun Systems Remarketing has introduced a
  262. 20Meg drive but I would rather invest the money in a hard disk drive
  263. that I can later use when I finally, if ever, decide to dump my XL.
  264.  
  265. On a related note, I notice that the 5 Meg Profile Hard disk uses a
  266. Seagate ST-506 drive- the same hard disk drive interface used in IBM
  267. PCs.  Has anyone tried upgrading the Profile with a 10 or 20 Meg IBM
  268. PCish ST-506?
  269.  
  270.  
  271. Ben
  272.  
  273. --
  274. Benjamin Britt
  275. USC/Information Sciences Institute
  276.  
  277. ------------------------------
  278.  
  279. From: howard@mtunj.ATT.COM (H. Moskovitz)
  280. Subject: Re: Which Is Better: DMCS or Concertware+?
  281. Date: 26 Aug 87 22:01:25 GMT
  282. Organization: The Second Door on the Right
  283.  
  284. In article <1377@killer.UUCP> ghoti@killer.UUCP (Alan Perry) writes:
  285. >
  286.  
  287. >I like best, it is Studio Session by MacNifty.  The instruments are digitized
  288.  
  289. I have two questions:
  290.  
  291.     1) Does it support MIDI (if so, how well)?
  292.  
  293.     2) How well does it print out scores on the LW? Does it support
  294.        ADOBE's Sonata font (like DMCS)?
  295.  
  296.  
  297. -- -----------------------------------------------------------
  298.         Howard Moskovitz
  299.     AT&T Bell Labs @ Liberty Corner, NJ
  300.         ihnp4!io!howard
  301.  
  302.  
  303. ------------------------------
  304.  
  305. From: eacj@batcomputer.tn.cornell.edu (Julian Vrieslander)
  306. Subject: Comments on SuperMac 19" Trinitron monitor system (longish)
  307. Date: 27 Aug 87 04:13:24 GMT
  308. Organization: Cornell Theory Center, Cornell University, Ithaca NY
  309.  
  310. Well, I recently installed a Mac II system, and I thought that some of
  311. you might be interested in hearing a bit about the 19" SuperMac monitor,
  312. since this is the new version with the Sony Trinitron tube.
  313.  
  314. First, some history for those who tuned in late.  SuperMac first
  315. introduced a color video adaptor card and 19" color monitor at the time
  316. of, or shortly after, the Mac II rollout.  They still sell that monitor,
  317. and it uses a tube made by Ikegami.  At the Boston Expo they introduced
  318. new 19" and 16" Sony Trinitron color monitors.  The suggested retail
  319. price for the 19" Sony is $700 more than the 19" Ikegami's, but most
  320. people think the Trinitron is sharper than the Ikegami.  The SuperMac
  321. Spectrum video card works with all of their color tubes.
  322.  
  323. Now for my mini-review.  First of all, be sure to measure your desk if
  324. you are thinking of buying one: this thing is *large* (21" from screen
  325. to rear panel). There are four plastic feet on the bottom, so a stand is
  326. optional.  We chose the tilt-swivel base, which raises the screen about
  327. 2 to 3".  This base is designed to sit on a desk top, and the resultant
  328. screen height is just about right (for me anyway).  I wouldn't put the
  329. monitor on top of the Mac II: the thing weighs about a hundred pounds. 
  330. If you really want the monitor over the Mac, SuperMac will sell you a
  331. beefy three legged stand that straddles the system box (the Mac can be
  332. pulled out at the front for changing cards, etc.).
  333.  
  334. The monitor seems well made and ergonomically sensible.  All user
  335. controls (horizontal and vertical convergence, contrast, vertical
  336. centering, on/off) are in front, below the screen.  The Trinitron
  337. monitor does not have have a degaussing button (like the Ikegami's), so
  338. it probably has automatic degaussing.
  339.  One curious note: the screen is advertised as 768 pixels high by 1024
  340. wide. But, at least for my sample, the actual pixel size is 768 by 1016.
  341.  This width was verified (on both my system and my dealer's demo system)
  342. by the Mousometer DA and by some test code I wrote as a doublecheck. 
  343. Where's the missing rowByte?
  344.  
  345. The Spectrum video adaptor card did not come with a slot shield (a metal
  346. stamping to seal the opening at the back of the system box against RFI
  347. emission), but SuperMac Tech Support has promised to mail one to me. 
  348. SuperMac's advertisements claim that the board can be programmed for 1,
  349. 2, 4 or 8 bits/pixel, but the boards shipping now do *not* work in 2 or
  350. 4 bit mode.  Tech Support says that a retrofix will be available. 
  351. Currently the board does not have GenLock capability, but they claim
  352. that this will be provided, possibly as an extra-cost plug-in.
  353.  
  354. Image quality is very impressive.  Convergence can be adjusted to within
  355. about one pixel's worth of misalignment from corner to corner.  Nine
  356. point text is not as clear as on the 9" screens of the little Macs, but
  357. still very readable.  The screen has an effective anti-reflection
  358. coating that enhances contrast.  If I were to pick nits about the
  359. picture quality, there would be two things to mention.  There are 2
  360. *very* fine horizontal lines that run horizontally across the screen at
  361. the 1/3 and 2/3 heights.  These lines, I am told, are seen on many
  362. Trinitrons and are a consequence of the tube's internal construction. 
  363. More noticable to me is a slight variation in screen brightness when
  364. rendering the medium gray of the desktop.  This appears in faint
  365. vertical bands, like interference fringes with 2 mm periodicity.  A
  366. techie at SuperMac told me that the effect is present in all units and
  367. can be eliminated by choosing another desktop pattern.  Perhaps it is a
  368. Moire interaction between the medium gray pattern and the shadowmask.
  369.  
  370. Documentation is adequate, but unimpressive.  The installation
  371. instructions appear to be written for the Ikegami, and are still
  372. labelled as a beta draft, at that.  There is also a sheet supplied by
  373. Sony, with a brief description of the monitor's controls, and
  374. connections.  I had no trouble getting the system to work, but a less
  375. technically oriented user might get confused by the mismatch between the
  376. hardware and the doco.
  377.  
  378. At the Boston Mac Expo, PCPC (the folks who make the MacBottom hard
  379. disks) were also introducing a 19" color monitor system for the Mac II. 
  380. Their systems ship with monitors from either Mitsubishi or Sony (the
  381. same 19" that SuperMac uses), but they were claiming that their video
  382. card was superior to SuperMac's.  This superiority was alleged to be due
  383. to a cleaner design with lower parts count, lower power dissipation, and
  384. less RFI emission, resulting in better reliability and a visably better
  385. picture.  Note, however, that their board runs *only* in 8 bits/pixel
  386. mode.  I could not see an obvious difference in picture quality between
  387. the PCPC and SuperMac systems demoed at the show, but I would be
  388. interested in hearing reports from others who have experience with both
  389. products.
  390.  
  391.  
  392. --
  393. Julian Vrieslander    (607) 255-3594
  394. Neurobiology & Behavior, W250 Mudd Hall, Cornell University, Ithaca NY 14853
  395. UUCP: {cmcl2,decvax,rochester,uw-beaver,ihnp4}!cornell!batcomputer!eacj
  396. ARPA: eacj@tcgould.tn.cornell.edu     BITNET: eacj@CRNLTHRY
  397.  
  398. ------------------------------
  399.  
  400. From: lsr@apple.UUCP (Larry Rosenstein)
  401. Subject: Re: MPW and MultiFinder
  402. Date: 26 Aug 87 21:14:06 GMT
  403. Organization: Advanced Technology Group, Apple Computer
  404.  
  405. In article <1639@watcgl.waterloo.edu> kdmoen@watcgl.UUCP (Doug Moen)
  406. writes:
  407. >
  408. >1) Will MPW (Macintosh Programmers Workshop) be compatible with MultiFinder?
  409.  
  410. MPW 2.0 is Multifinder aware; not only does it work with Multifinder,
  411. but it takes vantage of the Multifinder environment.
  412.  
  413. For example, if you are running Multifinder and launch an application
  414. from MPW, the MPW shell does not run its normal suspend script.  It
  415. simply uses sublaunching to have Multifinder run the application in a
  416. separate area of memory (exactly as if you had launched the app from the
  417. Finder).  Since MPW does not exit, there is no reason to save the state
  418. of variables, aliases, etc.
  419.  
  420. >2) Will the necessary calls to GetNextEvent (or whatever) be inserted
  421. >   into the MPW C compiler so that it can run as a background task under
  422. >   MultiFinder?
  423.  
  424. This was not done for MPW 2.0, so you can't run the compilers in the
  425. background under Multifinder.
  426.  
  427. --
  428. Larry Rosenstein
  429.  
  430. Object Specialist
  431. Apple Computer
  432.  
  433. AppleLink: Rosenstein1
  434. UUCP:  {sun, voder, nsc, mtxinu, dual}!apple!lsr
  435. CSNET: lsr@Apple.com
  436.  
  437. ------------------------------
  438.  
  439. [ The following messages were taken from the INFO-APPLETALK mailing list.
  440. - Jeff ]
  441.  
  442. From: voder!apple!andrews
  443. Subject: Mac File Representation
  444. Date: 22 Aug 87 22:36:51 GMT
  445. Organization: Apple Computer Inc., Cupertino, USA
  446.  
  447. Here is our first attempt at a proposal for representing Mac files on
  448. other file systems.  Please circulate it freely.  I welcome comments and
  449. suggestions, with the following caveat:
  450.  
  451. PLEASE KEEP YOUR COMMENTS BRIEF AND CONCISE.  I EXPECT A LOT OF FEEDBACK
  452. AND I CAN'T POSSIBLY WADE THROUGH A WHOLE LOT OF MATERIAL. I CANNOT
  453. REPLY TO EVERYONE PERSONALLY.
  454.  
  455. Please send useful comments and suggestions directly to me.  Look to
  456. this bulletin board for further drafts.
  457.  
  458. --------------------------------------------------------------------
  459.  
  460. AppleSingle and AppleDouble formats for file representation
  461.  
  462. A Draft Proposal from Apple Computer, Inc.
  463.  
  464. 21 August, 1987
  465.  
  466. Apple Computer is proposing two standards for representing Macintosh
  467. files on non-Macintosh file systems, with the goal of preserving all
  468. attributes characteristic of Macintosh files (Finder info, icons,
  469. comments) on file systems that do not support such attributes ("foriegn"
  470. file systems).  Experience seemed to indicate that a single format could
  471. not be devised that would be adequate for all cases, but that with two
  472. closely-related formats most needs could be served.  A secondary goal in
  473. designing these formats was to make them general enough so that they
  474. could be used to represent a file from any file system on any other file
  475. system.
  476.  
  477. Note that this is a draft and is subject to change.
  478.  
  479. The two formats are called AppleSingle and AppleDouble.  In AppleSingle
  480. format, all contents and attributes of a Macintosh file are kept in a
  481. single file on the foriegn file system.  Both forks, Finder info, icons,
  482. etc. are arranged in a single file with a simple structure.  This format
  483. is intended to be used primarily as a storage format; i.e., for those
  484. cases in which the Macintosh file must be stored on a foriegn file
  485. system and later reconstructed into a true Macintosh file.  
  486.  
  487. For those applications in which the users of the foriegn file system
  488. wish to access and perhaps modify the contents of the Macintosh file,
  489. AppleDouble format would be more appropriate.  Since most Macintosh
  490. applications keep the file "data" in the data fork, AppleDouble format
  491. saves the contents of the data fork in a separate foriegn file.  All
  492. other file attributes are kept in another file.
  493.  
  494. Specifically, Apple's proposal does not rule out the possibility of
  495. building applications that wish to access and modify MacSingle-format
  496. files.  Nor does it preclude using AppleDouble format for simple storage
  497. of Macintosh files.  We merely present them as alternatives.
  498.  
  499. The only assumption we have made is that each file system on which these
  500. file formats will be supported allows the creation of a simple file; an
  501. uninterpreted stream of bytes.  We have ruled out designing a format
  502. that relied on the creation of subdirectories, since some file systems
  503. do not support them.
  504.  
  505. Before getting into the discussion of the formats, some terms will be
  506. defined.  The term home file system will be used to mean the file system
  507. for which the file's contents were created.  A Unix application could
  508. create an AppleSingle file that holds a resource and data fork in which
  509. is contained a MacWrite-formatted document.  The home file system for
  510. such a file will be Macintosh Hierarchical File System (HFS).  In most
  511. cases, where a file is created and used on the same file system, the
  512. home file system will be that system.  An AppleSingle or AppleDouble
  513. file is usually another representation of the file's contents on a
  514. foriegn file system.
  515.  
  516. AppleSingle
  517.  
  518. An AppleSingle file contains a header followed by data.  The header is
  519. composed of several fixed fields and a list of entry descriptors, each
  520. pointing to an "entry".  Standard entries that Apple will define
  521. include:  Data Fork, Resource Fork, Real Name (name in the home file
  522. system), Comment, Icon, File Info, etc.  Each entry would be optional
  523. and may or may not appear in the file.
  524.  
  525.    Header:             Magic Number      (4 bytes)
  526.                        Version Number    (2 bytes)
  527.                        Home File System  (4 bytes, ASCII encoded)
  528.                        Number of entries (2 bytes)
  529.                    /   Entry ID          (2 bytes)
  530.    for each entry: |   Offset            (4 bytes)
  531.                    \   Length            (4 bytes)
  532.  
  533. The "Magic Number" field is modeled after the feature in Unix.  It is
  534. intended to be used in whatever way each foriegn file system desires to
  535. distinguish this file as one in AppleSingle format.  The Magic Number
  536. for AppleSingle format is $00051600 or 0x00051600.
  537.  
  538. The "Version Number" field is used to denote the version of AppleSingle
  539. format in case the format evolves (perhaps more fields would be added to
  540. the header).  The version described here is version $0001 or 0x1.
  541.  
  542. The "Home File System" is explained above.  For Macintosh files, the
  543. value of this field is 'mac ' or $6D616320 or 6D616320.  Others are
  544. shown below:
  545.  
  546.      Macintosh    'mac ' or $6D616320 or 0x6D616320
  547.      ProDOS       'pdos' or $70646F73 or 0x70646F73
  548.      MS-DOS       'mdos' or $6D646F73 or 0x6D646F73.
  549.      Unix         'unix' or $756E6978 or 0x756E6978.
  550.  
  551. We welcome suggestions for other file systems that should be included in
  552. this list.
  553.  
  554. The "Number of entries" field tells how many different entries are
  555. included in the file.  It is an unsigned 16-bit number, and may be zero.
  556. If non-zero, then that number of entry descriptors will immediately
  557. follow this field.
  558.  
  559. For each entry, the entry descriptor indicates just what the entry is,
  560. where the entry is located in the file, and how big the entry is.  Apple
  561. will define a set of Entry IDs and their values:
  562.  
  563.      Data Fork      1 (standard Mac Data Fork)
  564.      Resource Fork  2 (standard Mac Resource Fork)
  565.      Real Name      3 (the file's name in the home file system)
  566.      Comment        4 (standard Mac comment)
  567.      Icon, B&W      5 (standard Mac Black & White Icon)
  568.      Icon, Color    6 (standard Mac color icon)
  569.      File Info      7 (file information)
  570.      Dates          8 (Create, Modification, and Backup dates)
  571.  
  572. Apple reserves the range of Entry IDs from 0 to 32767 ($7FFF or 0x7FFF)
  573. for future use.  Apple will not arbitrate the use of the rest of the
  574. range; these values can be used by other systems to define their own
  575. types of entries.
  576.  
  577. The File Info entry will be different for each home file system.  For
  578. Macintosh HFS, the entry is 32 bytes long and consists of the standard
  579. Finder Info and Extended Finder Info fields.  [To be defined:  formats
  580. for MS-DOS, Unix, and ProDOS, etc.]
  581.  
  582. Icon entries will probably not appear in most files since they are
  583. typically stored as a bundle in the application file's resource fork.
  584.  
  585. The actual data representing the entry must be in a single contiguous
  586. block.  It is pointed to by the offset field, which is an unsigned
  587. 32-bit number indicating the byte offset from the start of the file to
  588. the start of the entry.  The entry length is also an unsigned 32-bit
  589. number representing the length in bytes.  The length may be zero.
  590.  
  591. After some number of entry descriptors, the actual entry data would
  592. appear.  The entries could appear in any order, but since the data fork
  593. is the entry that would be most commonly extended, Apple strongly
  594. recommends that the data fork entry always be kept last in the file to
  595. facilitate its extension.
  596.  
  597. It is possible to have holes in the file (unused space between entries).
  598. To find where the holes are, one must take the list of entry
  599. descriptors and sort them into increasing offset order.  If the offset
  600. field of an entry is greater that the offset plus length of the previous
  601. entry, then a hole exists between the entries.  This may be used to
  602. one's advantage; for example:  if a file's comment is 10 bytes long, one
  603. could create a hole of 190 bytes after the comment field to easily allow
  604. for the comment to later expand to its maximum length of 200 bytes. 
  605. Because an AppleSingle file may contain holes, every entry must be found
  606. by getting its offset from its entry descriptor - not by assuming that
  607. it begins after the previous entry.
  608.  
  609. Byte ordering in the file will follow 68xxx convention.  This is
  610. somewhat of a religious issue, but it was decided that picking one
  611. format was better than adding a flag to the file to indicate which
  612. ordering was being used, so that applications wouldn't have to have code
  613. to handle both cases.
  614.  
  615. AppleDouble
  616.  
  617. AppleDouble format is now easily described:  it is the same as
  618. AppleSingle format except that the data fork is kept in a separate
  619. foriegn file.  The file containing the data fork will be called the
  620. AppleDouble Data File, and the other file will be called the AppleDouble
  621. Header File.
  622.  
  623. The AppleDouble Data File consists of just the standard Macintosh Data
  624. Fork with no extra header at all.  The AppleDouble Header File has
  625. exactly the same format as the AppleSingle file, except that it does not
  626. contain a data fork entry.  The Magic Number of an AppleDouble Header
  627. File differs from that of an AppleSingle file so that applications can
  628. tell whether or not they need to look elsewhere for the data fork.  The
  629. Magic Number for AppleDouble format is $00051607 or 0x00051607.
  630.  
  631. The entries in the Header File could appear in any order, but since the
  632. resource fork (in this case) is the entry that would be most commonly
  633. extended, Apple strongly recommends that the resource fork entry always
  634. be kept last in the file to facilitate its extension.  The data fork is
  635. easily extended since it resides by itself in the Data File.
  636.  
  637. If it is possible on the foriegn file system, one could create a new
  638. type of entry that "pointed" to the AppleDouble Data File to make it
  639. easy to find.
  640.  
  641. -----------------------
  642.  
  643. AppleSingle format specifically will not include an algorithm for
  644. generating the AppleSingle file name from the "real" Macintosh name. 
  645. This was done because the foriegn file systems of interest differ quite
  646. a bit in the area of file name syntax, and since the  file's real name
  647. can be kept as an entry within the AppleSingle file.
  648.  
  649. The same is true for AppleDouble Data File names, yet we would like to
  650. propose a standard for deriving the AppleDouble Header File name from
  651. the AppleDouble Data File name.  Again, due to differing file name
  652. syntax, a standard per foriegn file system is proposed.  For example:
  653.  
  654.    On Unix systems, take the file's real name and by character
  655.    substitution, deletion, or truncation, derive an AppleDouble
  656.    Data File name that is at least one character less than the 
  657.    maximum file name length.  The AppleDouble Header File name
  658.    will be the same as the AppleDouble Data File name with a
  659.    preceding percent sign '%'.
  660.  
  661.    On ProDOS systems, take the file's real name and by character
  662.    substitution, deletion, or truncation, derive an AppleDouble
  663.    Data File name that is at least two characters less than the 
  664.    maximum file name length.  The AppleDouble Header File name
  665.    will be the same as the AppleDouble Data File name with a
  666.    preceding 'R.' (ASCII-R, period).
  667.  
  668.    On MS-DOS systems, take the file's real name and by character
  669.    substitution, deletion, or truncation, derive a name that is
  670.    at most eight characters long.  The AppleDouble Header File
  671.    name will be the derived name plus an extension of '.ADF'
  672.    (AppleDouble File).  The AppleDouble Data File name will be
  673.    the derived name plus whatever extension is most appropriate
  674.    in the MS-DOS world.  If the data fork is pure text (CR, LF)
  675.    the the Data File extension would be '.TXT'.  If the data fork
  676.    conformed to some other standard MS-DOS file format, it would
  677.    be given the appropriate extension.  This would have to be
  678.    decided by whatever application created the AppleDouble files.
  679.  
  680. And so on.  AppleDouble name derivations, to coin a term, would be
  681. defined for all the file systems of interest.  This would allow
  682. applications running on the foriegn file system (and human users as
  683. well) to easily see which files are AppleDouble pairs.  Knowledgeable
  684. users, if they know the derivation, could even rename the files in such
  685. a way so as to preserve the connection between the two.  There is no way
  686. to prevent one file of the pair from being inconsistently renamed, moved
  687. or deleted.
  688.  
  689. ------------------------------
  690.  
  691. From: palomar!joel%beowulf
  692. Subject: Remote file representation
  693. Date: Mon, 24 Aug 87 17:04:31 pdt
  694.  
  695. First, I'd like to thank Apple for sharing this before it's set in
  696. stone.  There are many Mac programmers who are on USENET,  (and also
  697. Delphi and Bix, which receive edited copies of USENET news) who can
  698. participate.
  699.  
  700. The spec seems well thought-out, but I have a few suggestions:
  701.  
  702. 1. Home File System should include:
  703.     'vms ' or $766D7320
  704.     'os2 ' or $6F734220
  705.    I'm not sure if 'unix' should be treated as a monolithic
  706.    whole, as the syntax of file names, at least, differs significantly
  707.    from System V (14 chars max) to BSD.
  708.  
  709. 2. The AppleDouble format does not address one important issue.
  710.    The data fork of a Macintosh file is not normally readable
  711.    by another file system.  To contrast it with three with
  712.    which I am familiar:
  713.     *) Mac: CR at end of each record
  714.     A) UNIX: LF at end of each record
  715.     B) MS-DOS: CR-LF at end of each record
  716.     C) VMS: preceeded by a binary length
  717.    If the data fork is to be readable, then it must be translated
  718.    into the native format, and its original format saved.
  719.  
  720.    I think there needs to be a line-translation entry to indicate
  721.    the original line delimiter so it can be restored from the
  722.    native format
  723.     Record Delim 9  1 or more delimiter characters
  724.    For example, a Mac file stored on MS-DOS would be stored with CR-LF
  725.    delimiters but with Record Delim = $0D.  (on VMS, you could use
  726.    RAT=CR, which would be an exact copy of the Mac data fork).
  727.  
  728.    The AFP or some other protocol also needs either record-
  729.    at-a-time i/o or a "What is this file's delimiter" query, so
  730.    that a Mac program can read a file directly from a UNIX
  731.    server (in LF-delimited form) and vice versa.
  732.  
  733. 3. The use of the icon ought to be better defined, or this will
  734.    vary all over the place.  For example, the spec ought to say
  735.    something like:
  736.     Applications normally include their icons, but documents
  737.     do not.
  738.    (or maybe all always include their icon)
  739.  
  740. 4. Again, their ought to be file naming guidelines for mapping
  741.    (recommendations for consistency, not absolute rules) so that 
  742.    there is similarity between various systems.  For example,
  743.      A) Case is stripped on systems that don't support case, so
  744.     Foo.C becomes FOO.C
  745.      B)    Spaces are mapped to "_" if available, otherwise to
  746.     another available non-alphanumeric special character.
  747.      C)    Standard mappings for Macintosh extended characters.
  748.     For example, all accented letters are stripped to their
  749.     IUMagString equivalents,
  750.         `e becomes e
  751.         c, becomes c
  752.     etc.  Characters that have no equivalent are removed
  753.     ((R), TM, (C), etc.) since they are likely to be noise
  754.     characters.
  755.  
  756. 5. Presumably if a new file is being created in this directory
  757.    and it truncates to an existing AppleSingle or AppleDouble
  758.    file, the program will check for the actual name and, if
  759.    different, choose a new truncated name to save the file.
  760.  
  761.    For example,
  762.  
  763.     'AntiDisestablish Text' and 'AntiDisestablish Text 2'
  764.    might be stored as
  765.     ANTIDIST. and ANTIDIS2.
  766.    on an MS-DOS system.
  767.  
  768. This is obviously an area where a standard is sorely needed, and as an
  769. A/UX user, I hope A/UX 1.0 implements the final  AppleDouble proposal.
  770.  
  771.     Joel West        
  772.     Palomar Software, Inc., POB 2635, Vista, CA  92083
  773.     joel%palomar.uucp@beowulf.ucsd.edu
  774.     ihnp4!crash!palomar!joel    joel@palomar.cts.com
  775.     AppleLink: D0619            MCI: Palomar
  776.  
  777. ------------------------------
  778.  
  779. End of Usenet Mac Digest
  780. ************************
  781. -------
  782.